Learning Objectives

After completing this lesson, you’ll be able to:

Running a Workspace

The easiest way to run a workspace on FME Flow is through the Run Workspace page. You can access it from the corresponding menu option:

Run Workspace in the FME Flow menu

On the Run Workspace page, you can choose a repository, workspace, and service to run a translation:

Run workspace page

When you select a workspace containing Published Parameters, those parameters are available to be set before running the translation.

Advanced Parameters

The Run Workspace page in FME Flow also has an additional section under Advanced. Clicking the arrow to the right of Advanced will expand the advanced parameters menu. These are FME Flow-specific parameters that fine-tune how the workspace will be run.

Advanced Parameters on Run Workspace page

Job Queue

Job Queues provide a way to send FME Flow jobs to specific Engines or to control the priority of job requests. This parameter allows you to select a predefined Queue to which this job should be sent when it is run. Job Queues can be created and edited from the Engine Management page.

Queued Job Expiry Time

This sets the maximum amount of time a job can wait in the Job Queue before being assigned to an engine and run. If a job waits longer than this amount of time in the Queue, it will not be run. This option is useful for time-sensitive jobs that you do not want to run after the specified time is exceeded.

Running Job Expiry Time

This sets the maximum amount of time a job can stay in the Running state. When this time is exceeded, the job will be cancelled automatically.

Other Ways to Run this Workspace

Additionally, in the Advanced section, you can create an FME Flow Workspace App or create a webhook to run your workspace.

Running a Job

When you are satisfied with the parameters, click the green Run button at the bottom of the page to run the translation. A progress dialogue will appear, indicating whether your workspace is Running or Queued. From this view, you can cancel the job or view the details:

Running a workspace

Once the workspace (job) has finished running, a completion message will appear, letting you know whether the translation was successful or if it failed.

Workspace has run

Note

Note that there are other ways to find and run a workspace. Recently published workspaces and workspaces "starred" as a favorite can be easily found on the interface landing page.
Additionally, it's possible to browse for a workspace to run by going through the Workspaces page, which is more like a file browser than a simple selection tool.

Note

Jobs are submitted to the FME Flow core, which then assigns them to engines. Having more engines means you can run more jobs simultaneously. Learn more.

Jobs

Information about all jobs that are running or have run on FME Flow will be stored so you can easily view activity on FME Flow. To access this, choose the menu option for Jobs and select Completed, Queued, or Running jobs to view:

Jobs menu

This opens the Jobs page, where you can see the status of jobs, whether Completed, Queued, or Running:

Jobs page

This allows you to check that the translation you just ran finished successfully or access the job log and more job details by clicking on the job.

The Filters menu at the top allows you to filter by User, Status, Engine, Repository, Workspace, Source Type, and Source Name. This is especially useful when the job history table runs to thousands of jobs. Filtering helps to find information about a specific job or, for example, to quickly find all jobs that resulted in a failure message.

Completed Jobs

Clicking on a completed job opens up a page showing information about that job; such as User, Status, Engine, Repository, Workspace, Source Type, and Source Name. You can also view, filter, and search the job log.

A series of buttons allow you to download the FME log from the translation, resubmit the job with a single click, view the workspace, and download the workspace:

Completed Job screen

This allows you to confirm that the workspace functioned correctly and filter for any errors or warnings. The job log on FME Flow has the same level of detail as the translation log within FME Form.

Queued and Running Jobs

Queued and Running jobs allow you to see what jobs FME Flow is currently handling. Jobs can be filtered by user, repository, source, engine they ran on, and more. 

One particularly useful feature is that these pages can be used to cancel jobs if they are no longer required.

Note

If your jobs are being queued regularly, talk to your FME Flow Administrator about different options like Job Queues, dedicated engines, or scheduling larger tasks to run outside of regular office hours.